fdb_move

Перемещение (переименование) объекта в файловой базе данных из одного пути в другой

Параметры запроса

• pult_apikey (строка, обязательный) - API-ключ.
• path (строка): Исходный путь объекта.
• dest (строка): Целевой путь для перемещения.
• strict (булево, опционально): Если true, возвращает ошибку при существовании dest. По умолчанию false.

Возвращаемые значения

• При успехе: Новый путь объекта (dest или скорректированный, если strict=false).
• При ошибке: Соответствующий код ошибки и описание (если есть).

Коды ошибок

• SERVER_ERROR_BUILDING_IN_PROGRESS: Операция запрещена во время сборки проекта.
• SERVER_ERROR_EDITOR_HOLD_OBJECT: Объект заблокирован другим редактором.
• SERVER_ERROR_OBJECT_NOT_FOUND: Исходный объект не найден.
• SERVER_ERROR_EDIT_ACCESS_DENIED: Нет прав на редактирование исходного или целевого пути.
• SERVER_ERROR_OBJECT_EXISTS: Целевой объект уже существует (только при strict=true).

Особенности

• Проверяет права доступа на исходный объект, его родительскую директорию и целевую директорию.
• Автоматически генерирует уникальное имя для dest, если объект уже существует и strict=false.
• Валидирует операции удаления и создания объекта перед перемещением.
• Записывает действие в журнал с указанием проекта и объекта.
• После перемещения необходима сборка проектов (editor_start_build)

Пример

https://webscada.ru/api/fdb_move?pult_apikey=31269DCE4F983A31FBE8B88DF67CDAE2&path=/projects/Проект1.project/nodes/Узел1.node&dest=/projects/Проект1.project/nodes/Узел2.node&strict=true